package org.example.admin.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.example.admin.dao.entity.UserDO;
import org.example.admin.dto.req.UserLoginReqDTO;
import org.example.admin.dto.req.UserRegisterReqDTO;
import org.example.admin.dto.req.UserUpdateReqDTO;
import org.example.admin.dto.resp.UserLoginRespDTO;
import org.example.admin.dto.resp.UserRespDTO;

/**
 * @author weibin
 * @since 2025/10/3 19:29
 */
public interface UserService extends IService<UserDO> {

    /**
     * 根据用户名获取用户
     *
     * @param username  用户名
     * @return  用户消息
     */
    UserRespDTO getUserByUsername(String username);

    /**
     * 判断用户名是否已存在
     *
     * @param username  用户名
     * @return  是否存在
     */
    Boolean hasUsername(String username);

    /**
     * 用户注册
     *
     * @param requestParam  用户注册请求参数
     */
    void register(UserRegisterReqDTO requestParam);

    /**
     * 根据用户名修改用户消息
     *
     * @param requestParam  用户修改请求参数
     */
    void updateUser(UserUpdateReqDTO requestParam);

    /**
     * 用户登录
     *
     * @param requestParam  用户登录请求参数
     * @return  用户登录成功后 token
     */
    UserLoginRespDTO login(UserLoginReqDTO requestParam);

    /**
     * 检查用户是否已登录
     *
     * @param username 用户名
     * @param token token
     * @return  是否已登录
     */
    Boolean checkLogin(String username, String token);

    /**
     * 用户退出登录
     *
     * @param username 用户名
     * @param token token
     */
    void logout(String username, String token);
}
